/*
 * Copyright 2018-10-14 21:39:18 The JA-SIG Collaborative. All rights reserved.
 * distributed with thi file and available online at
 */
package com.lap.scp.erp.core;

import java.util.List;

import com.lap.scd.commons.core.exception.ManagerException;
import com.lap.scd.commons.page.Page;
import com.lap.scp.erp.domain.CustomerDO;
import com.lap.scp.erp.query.CustomerQueryVO;

/**
 * <pre>
 *  客户信息，提供给公司工程、项目 业务操作对象，保持事务一致，尽量在这里减少操作时间，
 *  比如：初始化数据（除非跟数据库交互），尽量不要在该层操作，
 *  不然会拉长事务的时间，加大对数据库的锁（不一定是行锁、全数据锁）时间。
 *
 *  控制层统一命名规则：
 *  增加保存 	insertXX,
 *  修改保存 	updateXX,
 *  查询分页 	queryPage,
 *  根据ID查询 	queryById,
 *  删除 		deleteById
 *
 * </pre>
 * 
 * @author 劳水生 Exp
 * @Date 2018-10-14 21:39:18
 * @since 2.0.0
 */
public interface CustomerManager {
	/**
	 * <pre>
	 * 新增 客户信息，提供给公司工程、项目
	 * </pre>
	 *
	 * @param customerDO
	 * @throws ManagerException
	 */
	void insertCustomer(CustomerDO customerDO) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID删除 客户信息，提供给公司工程、项目
	 * </pre>
	 *
	 * @param customerId
	 * @return 更改数量
	 * @throws ManagerException
	 */
	int deleteById(Integer customerId) throws ManagerException;

	/**
	 * <pre>
	 * 分页查询客户信息，提供给公司工程、项目
	 * </pre>
	 *
	 * @param page
	 * @param queryVO
	 * @return 数据集合
	 * @throws ManagerException
	 */
	List<CustomerDO> queryPage(Page page, CustomerQueryVO queryVO) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID查询客户信息，提供给公司工程、项目
	 * </pre>
	 *
	 * @param customerId
	 * @return CustomerDO
	 * @throws ManagerException
	 */
	CustomerDO queryById(Integer customerId) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID修改客户信息，提供给公司工程、项目
	 * </pre>
	 *
	 * @param customerDO
	 * @return 修改变更的数量
	 * @throws ManagerException
	 */
	int updateCustomer(CustomerDO customerDO) throws ManagerException;

	/**
	 * <pre>
	 * 查询默认2000条记录的客户信息
	 * </pre>
	 * 
	 * @return
	 * @throws ManagerException
	 */
	List<CustomerDO> queryList() throws ManagerException;

}
